Skip to content

docs: Add macOS full build from source instructions#123

Merged
kblaschke merged 3 commits intoprojectM-visualizer:masterfrom
monsterwendy:docs/macos-build-from-source
May 8, 2026
Merged

docs: Add macOS full build from source instructions#123
kblaschke merged 3 commits intoprojectM-visualizer:masterfrom
monsterwendy:docs/macos-build-from-source

Conversation

@monsterwendy
Copy link
Copy Markdown
Contributor

The existing macOS section only covers generating an Xcode project for frontend-sdl2, but omits the prerequisite step of building libprojectM from source. Pre-built macOS binaries are not published, leaving macOS users without a working path.

This adds a self-contained walkthrough under the existing ### macOS section covering:

  • Homebrew prerequisites
  • Building libprojectM from source with CMAKE_INSTALL_PREFIX
  • Building frontend-sdl2 with CMAKE_PREFIX_PATH pointing at the libprojectM install
  • Where to find the resulting .app and how to configure it

Tested on macOS (Apple Silicon) as of April 2026.

Wendy added 2 commits April 28, 2026 20:35
The existing macOS section only covers generating an Xcode project for
frontend-sdl2, but omits the prerequisite step of building libprojectM
from source. Pre-built macOS binaries are not published, leaving macOS
users without a working path.

This adds a self-contained walkthrough covering Homebrew deps, building
libprojectM with CMAKE_INSTALL_PREFIX, and building frontend-sdl2 with
CMAKE_PREFIX_PATH pointing at that install.
@kblaschke
Copy link
Copy Markdown
Member

kblaschke commented Apr 30, 2026

Looks good!

I'd personally recommend to additionally suggest using -DENABLE_MACOS_FRAMEWORK=ON when configuring the libprojectM build on macOS to compile/install it as a .framework bundle (when using master or releases 4.2+), which might be easier to work with for (some) Xcode users.

@monsterwendy
Copy link
Copy Markdown
Contributor Author

Good call — I've updated the PR to include that as an optional flag with a note explaining it's for libprojectM 4.2+ and useful for Xcode integration. Thanks for the review!

Copy link
Copy Markdown
Member

@kblaschke kblaschke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks for the contribution!

@kblaschke kblaschke merged commit 49863dd into projectM-visualizer:master May 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants